home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypercrd / xcmds / dvlprstc.hqx / Developer Stack 1.3r / card_38381.txt < prev    next >
Text File  |  1991-04-30  |  2KB  |  51 lines
  1. -- card: 38381 from stack: in.3r
  2. -- bmap block id: 0
  3. -- flags: 0000
  4. -- background id: 3837
  5. -- name: FormatNumPadded
  6.  
  7.  
  8. -- part contents for background part 10
  9. ----- text -----
  10. 47
  11.  
  12. -- part contents for background part 5
  13. ----- text -----
  14. FormatNumPadded
  15.  
  16. -- part contents for background part 6
  17. ----- text -----
  18.  
  19. This XFCN will take any value up to about 190 chars long and strip all chars except a leading minus sign 0 - 9 and a decimal point. It will return a formatted number with or without a dollar sign and with a specified number of decimal places in the form:  (-)($)###,###,###(.)#####.  It will pad the number with zeros or truncate it, depending on the number of decimal places specified.
  20.  
  21. This is free. All I ask is to be notified of any suggestions or bugs found, and a credit line if you use it in released stacks. LightSpeed C source available on request.
  22.  
  23. Copyright 1988. All rights reserved.
  24. Dwight Mayo
  25. GEnie, MacNet - DMAYO
  26. Compuserve - 76257,3303
  27.  
  28.  
  29.  
  30. -- part contents for background part 27
  31. ----- text -----
  32. XFCN
  33.  
  34. -- part contents for background part 7
  35. ----- text -----
  36. Syntax:
  37.  
  38. formatNum(Value,DollarSign,NumberofDecimals)
  39.  
  40. Value can be any char and up to 190 chars long.  formatNum will strip any char that is not a negative sign or a number (between 0 and 9) and will return a positive or negative formatted number.
  41.  
  42. NOTE: You must include the negative sign if this is to be a negative number (e.g.,-123). 
  43.  
  44. If DollarSign is zero or left out, then no "$" wil be included.
  45. If DollarSign is a 1, then a "$" will be included.
  46.  
  47. If NumberofDecimals is zero or left out, then no "." will be included, and any characters after the decimal you have in the string will be gone as well. This is also how you do truncating (i.e., if your begining number is 12345.12345 and you specify three decimal places, the returned number will be 12345.123). 
  48.  
  49. If NumberofDecimals is greater then zero, you will get that many decimal places. If you don't include enough characters, then the return string will be padded with zeros.
  50.  
  51.